Inside Macintosh: QuickTime Components /

Chapter 5 - Sequence Grabber Components / Sequence Grabber Components Reference

Sequence Grabber Component Functions / Working With Channel Characteristics

SGGetChannelVolume

The SGGetChannelVolume function allows you to determine a channel's sound volume setting.

pascal ComponentResult SGGetChannelVolume (SGChannel c,
                                           short *volume);

c

Specifies the reference that identifies the channel for this operation. You obtain this reference from the SGNewChannel function, described on page 5-29.

volume

Contains a pointer to an integer that is to receive the volume setting of the channel represented as a 16-bit, fixed-point number. The high-order 8 bits contain the integer part of the value; the low-order 8 bits contain the fractional part. Volume values range from -1.0 to 1.0. Negative values play no sound but preserve the absolute value of the volume setting.

SEE ALSO

You establish the volume setting by calling the SGSetChannelVolume function, described in the previous section.